Add Audit your Classic API dependencies guide - #6349
Draft
brentschaus-okta wants to merge 4 commits into
Draft
Conversation
New guide (OKTA-1216283) helps developers inventory Classic Engine authentication dependencies (Authn API, Factors API, Sessions API, older Sign-In Widgets, Classic-era SDKs) still running after an OIE upgrade, and map each one to the supported Identity Engine path that should replace it. Part of the Modernize your sign-in and SSO flow with Okta Identity Engine journey (not yet published), registered under the existing Okta Identity Engine upgrade nav section for now. Co-Authored-By: Claude Code
Tightens prose in the new audit guide: converts remaining passive voice to active, removes future-tense "should" in favor of present tense, varies sentence length within paragraphs, and trims a few sentences for concision. Also links the new guide from the Classic Engine oriented docs that should point to it: the OIE upgrade overview, sign-in overview, the pre-upgrade integration discovery guide, the prepare-upgrade journey, and the sessions, API changes, sign-in widget, SDK, and MFA enrollment policy guides that map to specific Classic API rows in the new guide. Co-Authored-By: Claude Code
Applies the same style pass used on the new Classic API dependencies
guide to this pre-existing doc, which was blocking the PR at an
Acrolinx score of 72 (minimum 80). Splits several run-on sentences
(one at 40 words, one at 37, one at 33), fixes two ungrammatical
sentences ("Whether you edit... when you click...", "Modify an
existing... to a factored one"), converts passive constructions to
active, removes redundant "you need to" and duplicate create-policy
explanations, and drops weak "The following are" openers.
Co-Authored-By: Claude Code
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description:
Adds a new guide, Audit your Classic API dependencies, and cross-links it from the Classic Engine oriented docs that should point to it:
docs/guides/oie-upgrade-audit-classic-api-dependencies/: inventories Classic Engine authentication dependencies (the Classic Authentication API, the Factors API, the Sessions API, older self-hosted Sign-In Widgets, and Classic-era SDKs) that may still be running after an Identity Engine upgrade, and maps each one to the Identity Engine path that should replace it.docs/guides/index.mdand adds a nav entry innavbar.const.jsunder the existing Okta Identity Engine upgrade section.TODOHTML comments, matching the pattern used in Align Plan embedded auth app upgrades guide with OIE modernization journey #6333, so they don't produce broken links.oie-upgrade-mfa-enroll-policy): splits several run-on sentences, fixes two ungrammatical sentences, converts passive voice to active, and removes redundant wording. This was needed to clear the Acrolinx gate, which was blocking this PR at a score of 72 (minimum 80).Resolves:
Vercel Preview Link:
Preview link